home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / old-compression / cl_aware.z / cl_aware
Encoding:
Text File  |  2002-10-03  |  9.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))                                                    ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cl_aware, CLaware - Aware Audio Schemes in the Compression Library
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ccccllll....hhhh>>>>
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      This man page describes the Aware audio compression algorithms that are
  18.      installed in the Compression Library (CL).  Two Aware schemes are
  19.      currently supported.
  20.  
  21.      1. CCCCLLLL____MMMMPPPPEEEEGGGG1111____AAAAUUUUDDDDIIIIOOOO____AAAAWWWWAAAARRRREEEE  The ISO/MPEG-audio standard algorithm
  22.                               with layers I and II.
  23.  
  24.      2. CCCCLLLL____MMMMUUUULLLLTTTTIIIIRRRRAAAATTTTEEEE____AAAAWWWWAAAARRRREEEE    The Aware-proprietary MultiRate I
  25.                               lossless or low-distortion algorithm.
  26.  
  27.      Each scheme is accessed through the standard CL API, described in
  28.      CLintro(3dm).  Listed below are the parameters that may be used with
  29.      these two codecs.  Note that parameters described in cl_mpeg1(3dm) are
  30.      currently not supported for CL_MPEG1_AUDIO_AWARE.
  31.  
  32.  
  33. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS :::: GGGGEEEENNNNEEEERRRRAAAALLLL CCCCLLLL
  34.      The following general CL parameters are useful for the Aware codecs.
  35.  
  36.      CCCCLLLL____FFFFOOOORRRRMMMMAAAATTTT
  37.           Indicates the format of the components of the original uncompressed
  38.           audio.  Default is CL_FORMAT_STEREO_INTERLEAVED, legal alternative
  39.           is CL_FORMAT_MONO.
  40.  
  41.      CCCCLLLL____BBBBIIIITTTTSSSS____PPPPEEEERRRR____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT
  42.           Informs the scheme of the width of the audio samples (assumed to
  43.           be linear two's complement).  Currently, the only supported value
  44.           is 16.
  45.  
  46.      CCCCLLLL____FFFFRRRRAAAAMMMMEEEE____RRRRAAAATTTTEEEE
  47.           Tells the scheme the sampling rate of the uncompressed audio.
  48.           Default is 44100.0 Hz.  Legal values for the MPEG algorithm are
  49.           32000.0, 44100.0, and 48000.0 Hz.  Legal values for the MultiRate
  50.           algorithm are 8000.0, 11025.0, 16000.0, 22050.0, 32000.0, 44100.0,
  51.           and 48000.0 Hz.
  52.  
  53.      CCCCLLLL____CCCCOOOOMMMMPPPPRRRREEEESSSSSSSSIIIIOOOONNNN____RRRRAAAATTTTIIIIOOOO
  54.           A read-only parameter.
  55.  
  56.      CCCCLLLL____EEEEXXXXAAAACCCCTTTT____CCCCOOOOMMMMPPPPRRRREEEESSSSSSSSIIIIOOOONNNN____RRRRAAAATTTTIIIIOOOO
  57.           A read-only parameter.  It is true if CL_COMPRESSION_RATIO is
  58.           exact, and false if the ratio is a worst-case estimate.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))                                                    ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      CCCCLLLL____FFFFRRRRAAAAMMMMEEEESSSS____PPPPEEEERRRR____CCCCHHHHUUUUNNNNKKKK
  75.           A read-only parameter.  This is the number of audio frames which
  76.           are compressed at one time by the scheme.  The data that are passed
  77.           to clCompress should be in multiples of this size.
  78.  
  79.      CCCCLLLL____FFFFRRRRAAAAMMMMEEEE____TTTTYYYYPPPPEEEE
  80.           A read-only parameter.  Indicates the status of the next frame to be
  81.           processed is either CL_KEYFRAME (i.e. the first frame in a compressed
  82.           chunk) or CL_PREDICTED (all other alignments).  This should always be
  83.           CL_KEYFRAME if the CL_FRAMES_PER_CHUNK parameter is followed.  Note
  84.           that this definition is somewhat different than the general usage
  85.           given in CLintro(3dm).
  86.  
  87.      CCCCLLLL____SSSSPPPPEEEEEEEEDDDD
  88.           The CL_SPEED parameter takes values from 1.0 to 100.0.  It has no
  89.           effect during compression.  During decompression, it controls the
  90.           computational complexity by controlling several factors:
  91.           sample rate decimation, combining of stereo channels, filter shape
  92.           (MPEG only), and lossy_decode (MultiRate only).
  93.  
  94.           The user of this parameter should be advised that changing it may
  95.           cause the sampling rate, total number of sample frames available,
  96.           and sample frames per compressed chunk to be changed.
  97.  
  98.           After modifying this parameter, the values of CL_FRAME_RATE and
  99.           CL_FRAMES_PER_CHUNK should be queried for their new values.
  100.  
  101.  
  102. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS :::: AAAAWWWWAAAARRRREEEE
  103.      These parameters are specific to the Aware codecs.
  104.  
  105.      CCCCLLLL____AAAAWWWWAAAARRRREEEE____CCCCHHHHAAAANNNNNNNNEEEELLLL____PPPPOOOOLLLLIIIICCCCYYYY
  106.           Selects the treatment of stereo signals.
  107.  
  108.           CL_AWARE_STEREO       indicates that the channels are part of a
  109.                                 single multi-channel signal.
  110.  
  111.           CL_AWARE_JOINT_STEREO stereo redundancy exploited by coding high
  112.                                 frequency subbands together.  Not supported
  113.                                 under MultiRate algorithm.
  114.  
  115.           CL_AWARE_INDEPENDENT  the channels are unrelated and coded
  116.                                 separately; e.g. multilingual sound tracks.
  117.  
  118.           Note that any of these options are equivalent for single channel
  119.           signals.
  120.  
  121.      CCCCLLLL____AAAAWWWWAAAARRRREEEE____BBBBIIIITTTTRRRRAAAATTTTEEEE____PPPPOOOOLLLLIIIICCCCYYYY
  122.           Provides for different modes of bit assignment:
  123.  
  124.           CL_AWARE_FIXED_RATE  (MPEG only) A fixed bitrate is used to code
  125.                                all of the channels.  This is the default for
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))                                                    ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))
  137.  
  138.  
  139.  
  140.                                MPEG audio.  See CL_AWARE_BITRATE_TARGET.
  141.  
  142.           CL_AWARE_CONST_QUAL  bitrate allowed to vary to satisfy MPEG
  143.                                psychoacoustic model or MultiRate data
  144.                                requirements (90+dB).  This is the default
  145.                                for the MultiRate algorithm.  See
  146.                                CL_AWARE_NOISE_MARGIN.
  147.  
  148.           CL_AWARE_LOSSLESS    (MultiRate only) The data is coded losslessly.
  149.  
  150.      CCCCLLLL____AAAAWWWWAAAARRRREEEE____NNNNOOOOIIIISSSSEEEE____MMMMAAAARRRRGGGGIIIINNNN
  151.           Used in conjunction with CL_AWARE_CONST_QUAL.  Provides for
  152.           specification of the noise-to-mask ratio in MPEG psychoaccoustics:
  153.           Zero yields a theoretic psychoacoustic imperceptible compression.
  154.           Positive values provide more compression and noise becomes audible.
  155.           Negative values cause less compression and less perceptible noise.
  156.  
  157.           For MultiRate, sets the noise-floor at -90 dB below the signal level.
  158.           This is the only valid MultiRate setting at this time.
  159.  
  160.      CCCCLLLL____AAAAWWWWAAAARRRREEEE____BBBBIIIITTTTRRRRAAAATTTTEEEE____TTTTAAAARRRRGGGGEEEETTTT
  161.           (MPEG only) Used in conjunction with CL_AWARE_FIXED_RATE.
  162.           Determines the output data rate in bits per second.  The allowed
  163.           values are:
  164.  
  165.           MPEG layer I:
  166.           32000, 64000, 96000, 128000, 160000, 192000, 224000
  167.           256000, 228000, 320000, 352000, 384000, 416000, 448000
  168.  
  169.           MPEG layer II:
  170.           32000, 48000, 56000, 64000, 80000, 96000, 112000, 128000,
  171.           160000, 192000, 224000, 256000, 320000, 384000
  172.  
  173.      CCCCLLLL____AAAAWWWWAAAARRRREEEE____LLLLAAAAYYYYEEEERRRR
  174.           (MPEG only) Selects the MPEG layer. Default is
  175.           CL_AWARE_MPEG_LAYER_II for layer II, other legal value is
  176.           CL_AWARE_MPEG_LAYER_I for layer I.
  177.  
  178.  
  179. NNNNOOOOTTTTEEEESSSS
  180.      Aware compression is also accessible through the Audio File Library.  For
  181.      more information see AFaware(3dm).
  182.  
  183.      In order to use these schemes, a NetLS license needs to be obtained from
  184.  
  185.      Aware, Inc.
  186.      One Memorial Drive
  187.      Cambridge, MA 02142 USA
  188.  
  189.      phone:  (617) 577-1700
  190.      fax:    (617) 577-1710
  191.      e-mail: sales@aware.com
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))                                                    ccccllll____aaaawwwwaaaarrrreeee((((3333ddddmmmm))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      mpeg(4), CLintro(3dm), cl_mpeg1(3dm), aware(5), AFaware(3dm)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.